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FIELD OF THE INVENTION 

The present invention relates to messaging functions, and more particularly to 
building table functions that access messaging data and convert the messaging data into 
relational table format. 

BACKGROUND OF THE INVENTION 

Just as computers have become more and more prevalent in everyday life, networks 
of linked computers have become important in distributing information amongst computer 
users. Many computer systems are organized according to a client/server metaphor. In 
client/server computing, in general, end users are each provided with a desktop computer or 
terminal known as a "client. " The clients are connected using a network to another computer 
known as a "server", because its general function is to serve or fulfill requests submitted by 
clients. Application programs running on the clients prepare requests and transmit them to 
the server over the network. A network of computers can be any number of computers that 
are able to exchange information with one another. The computers may be arranged in any 
configuration and may be located in the same room or in different countries, so long as there 
is some way to connect them together (for example, by telephone lines or other 
communication systems) so they can exchange information. Just as computers may be 
connected together to make up a network, networks may also be connected together through 
tools known as bridges and gateways. These tools allow a computer in one network to 
exchange information with a computer in another network. 
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In order to account for the fact that different computers connected to such a network 
may operate using different protocols and/or data formats, and also that different computers 
may be located in different time zones, asynchronous messaging and queuing software 
products have been developed. Queuing can be used to implement deferred execution of 
work. In a system with queuing, a request for work is entered into a queue of requests, and 
the system defers processing of the request until later, such as when the requesting process 
has completed the task, process, or transaction that created the request. Queuing has been 
recognized as an important component of systems that mimic human business processes or 
work flow. 

Messaging and queuing provide a method of inter-program communication which 
allows programs to send and receive application-specific data without having a direct 
connection established between them. A message consists of two parts-application data and 
a message descriptor containing control information. The application data in a message is 
defined and supplied by the application program which sends the message. There are no 
constraints on the nature of the data in a message (for example, it could consist of one or 
more bit strings, character strings, binary integers, etc). In addition to the application data, a 
message has associated with it some ancillary data. This is information that specifies the 
properties of the message, and is used by the message queuing service to decide how the 
message should be processed. Some of this information must be specified by the sending 
application. 

A message queue is a named object in which messages accumulate and from which 
they are later removed. Each queue belongs to one particular queue manager (which is the 
system service that provides the message-queuing facilities used by applications), and the 



SVL9-2001-0074US1V2304P 



2 



queue manager is responsible for the maintenance of that queue. A message queue is not 
merely a stack: when messages are added to a queue, they are added at the end, and when 
messages are taken from a queue they are normally removed from the front (although 
facilities do exist for reading messages in other than FIFO (first-in first-out) order). The 
physical representation of a message queue depends on the environment but can be a buffer 
or buffers in main storage, a file or files on disk or other permanent storage device, or both 
of these. The physical management of message queues is entirely the responsibility of a 
queue manager, and such details are not made apparent to application programs. 
Applications can view a message queue simply as a "black box" in which messages 
accumulate. Applications have access to message queues by using message queuing API 
(application program interface) calls-obtaining message queuing services by using the 
message queuing calls to communicate with the queue manager that is installed on the same 
system as the application (i.e. the local queue manager). 

Applications communicate by agreeing to use particular named message queues, 
sending messages to the specific target queues that the application programs have agreed to 
read from. The locations of these queues need not be apparent to the applications which send 
the messages; each application interacts only with its local queue manager, and it is the 
network of interconnected queue managers that is responsible for moving the messages to 
the intended queues. In this way, the message queuing software greatly simplifies the level 
of complexity that is required of the application programs, removing the need for them to 
implement their own complex communications controls. By way of example, message 
queuing communication between programs, using batch transfer of messages between 
adjacent network nodes is provided by the MQSeries family of software products from IBM 
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Corporation, Armonk, NY. 

While a variety of applications are able to communicate via message queues, of 
particular interest in today's computing environment are relational database applications. 
Relational DataBase Management System (RDBMS) software using a Structured Query 
Language (SQL) interface is well known in the art. The SQL interface has evolved into a 
standard language for RDBMS software and has been adopted as such by both the American 
Nationals Standard Organization (ANSI) and the International Standards Organization (ISO). 

In RDBMS software, all data is externally structured into tables. The SQL interface 
allows users to formulate relational operations on the tables either interactively, in batch 
files, or embedded in host languages such as C, COBOL, etc. Operators are provided in SQL 
that allow the user to manipulate the data, wherein each operator operates on either one or 
two tables and produces a new table as a result. The power of SQL lies on its ability to link 
information from multiple tables or views together to perform complex sets of procedures 
with a single statement. 

In patent application no. 09/731,088, entitled, INTEGRATION OF MESSAGING 
FUNCTIONS AND DATABASE OPERATIONS, filed December 5, 2000, assigned to IBM 
Corporation and incorporated herein by reference, message queuing functions are integrated 
with database operations to combine message queuing communications and database access. 
User-defined functions (UDFs) are used to build messaging functions that can place a 
message on a queue, retrieve and read (non-destructively) one or more messages from the 
queue. These messaging functions are invoked by SQL statements and therefore, messaging 
data can be accessed using standard SQL operations. 

While the above referenced patent application operates well for its intended purpose, 
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i.e., integrating messaging functions and database operations, the messaging data returned to 
a client is in the same format as it is in the messaging system. Specifically, the returned 
messaging data is presented to the client as a string of characters or a message string. 
Generally, in this raw form, the messaging data cannot be used in a database system. For 
example, the message string cannot be inserted into a table in a database unless it represents 
a single data column. Thus, the message string must be converted into relational database 
format, i.e., a row with columns for a table. The client must perform several operations on 
the message string, e.g., parsing, in order to put it in a format for use by the database system. 

While not necessarily complicated, converting the message data is tedious and time- 
consuming. The user would be required to write conversion code within an application 
program, or create additional UDFs to perform the conversion within a single SQL 
statement. 

Accordingly, a need exists for accessing messaging data and automatically 
converting that data into relational table format. The method and system should allow the 
client to customize the table format, to determine the message format, and to preview, i.e., 
test, the intended result. The method and system also should allow the client to perform 
database operations on the messaging data in a single SQL statement. The present invention 
addresses such a need. 

SUMMARY OF THE INVENTION 

The present invention is directed to a method and system for converting messaging 
data into a relational table format in a database system, wherein the messaging data is within 
a messaging system. The method and system of the present invention includes providing a 
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table function that includes a plurality of table formatting specifications. The method and 
system of the present invention also includes invoking the table function to access the 
messaging data, and to convert the messaging data into specific data types according to the 
table formatting specifications, thereby transforming the messaging data into the relational 
table format. 

Through aspects of the method and system of the present invention, the table 
function invokes at least one user defined function within the database system. Preferably, 
the table function is also a user-defined function. The table function can be used within a 
single SQL statement to access and convert the message data, and to populate directly a 
relational table. The user is no longer required to perform conversion steps because the 
conversion is automatically performed by the table function. Moreover, a table view can be 
created and utilized by a user to select a message and then have the selected message string 
returned in relational table format. 

BRIEF DESCRIPTION OF THE DRAWINGS 

Figure 1 illustrates an overall block diagram of a computer system network in 
accordance with the present invention. 

Figure 2 illustrates a flow chart illustrating a process in accordance with a preferred 
embodiment of the present invention. 

Figure 3 illustrates a dialog window prompting a user to select a UDF type in 
accordance with a preferred embodiment of the present invention. 

Figure 4 illustrates a dialog window prompting a user to specify a UDF name in 
accordance with a preferred embodiment of the present invention. 
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Figure 5 illustrates a dialog window prompting a user to specify a database where the 
UDF will be stored in accordance with a preferred embodiment of the present invention. 

Figure 6 illustrates a dialog window prompting the user to specify the location of a 
message queue in accordance with a preferred embodiment of the present invention. 

Figure 7 illustrates a dialog window prompting the user to specify how the message 
data is formatted in accordance with a preferred embodiment of the present invention. 

Figure 8 illustrates a dialog window prompting the user to provide column 
definitions in accordance with a preferred embodiment of the present invention. 

Figure 8A illustrates an Add Column dialog window in accordance with a preferred 
embodiment of the present invention. 

Figure 8B illustrates a sample result in accordance with a preferred embodiment of 
the present invention. 

Figure 9 illustrates a dialog window prompting a user to choose various options in 
accordance with a preferred embodiment of the present invention. 

Figure 10 illustrates a summary window in accordance with a preferred embodiment 
of the present invention. 

Figure 10A illustrates a window showing SQL statements making up the table UDF 
in accordance with a preferred embodiment of the present invention. 

DETAILED DESCRIPTION OF THE INVENTION 

The present invention relates to messaging functions, and more particularly to 
building table functions that access messaging data and convert the messaging data into 
relational table format. The following description is presented to enable one of ordinary skill 
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in the art to make and use the invention and is provided in the context of a patent application 
and its requirements. Thus, the present invention is not intended to be limited to the 
embodiment shown, but is to be accorded the widest scope consistent with the principles and 
features described herein. 

As shown in FIG. 1, a plurality of computer systems 10a, 10b ? 10c are interconnected 
via a network 20 (which could be the public Internet or a private intra-corporate Intranet or 
wide area network). It should be appreciated that although FIG. 1 illustrates a network of 
computer systems, this is meant to be exemplary and not restrictive of the type of 
environment suitable for the aspects of the present invention. Thus, the aspects may also be 
provided within a single computing system environment. 

One of the computer systems (10c) is shown expanded for further illustration. As is 
shown, computer system 10c has a processor 50 for controlling the overall operation of the 
computer system 10c, a high speed cache memory 40, a long-term storage device 60 (e.g., 
hard disk drive), a message queue 30 managed by messaging software (not shown), such as a 
message queue manager like MQSeries® running on the computer system 1 0c, and a 
database program mechanism 80, e.g., an RDBMS system, such as DB2. User defined 
functions 70 (UDFs) that include the messaging functions are typically part of the database 
program mechanism 80. 

In general, there exists a hierarchy of data processing system resources that includes 
a message oriented middleware on top of the operating system (using the operating system 
resources) and underlying the application programs. The messaging software provides 
support for a number of application programs, which are the business applications run by a 
system user (e.g. an airline passenger booking facility run by a travel agency). It should be 
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noted that the message queue 30 (when persistence is desired) and database 80 would 
usually exist in the long-term storage device 60 (or other suitable computer readable 
medium), but these items have been shown separately in FIG. 1 for functional clarity. 

During messaging operations, whenever a new message destined for computer 
system 10c is received over network 20 from one of the other computer systems (e.g., 10a or 
10b), the message is stored in the message queue 30. The data associated with the message is 
stored in long term storage 60 when persistence is desired. When the processor 50 requests 
that a particular message be dequeued, that message's associated data is retrieved from 
storage 60 and provided to processor 50. 

In accordance with a preferred embodiment of the present invention, a programming 
module running on a client computer system (e.g., 10a, 10b) builds a table function that can 
access the messaging data stored in the message queue 30 and convert that data into specific 
data types in relational table format. The table function is a UDF that invokes at least one 
other UDF, which preferably includes a messaging function. Through the messaging 
function, the table function is able to retrieve (destructively read) or read messaging data. 
The table function then converts the messaging data into specific data types in relational 
table format. 

Figure 2 is a flow chart that illustrates a process in accordance with a preferred 
embodiment of the present invention. As is shown, the process starts in step 1 10 by building 
the table function. When the client invokes the table function, e.g., within an SQL 
statement, the table function accesses messaging data stored in a particular message queue 
30, in step 120, by invoking an appropriate messaging function UDF 70. The messaging data 
is read or retrieved as a message string, which is then parsed by the table function in step 
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130. 

By parsing the message string, the table function extracts the appropriate data from 
the message, e.g., application data. For example, the message string can be parsed as a 
delimited message where each delimited sub-string is treated as data of a relational table 
column. The message string can also be parsed as a fixed length column string where client 
specified string positions and lengths designate a sub-string that is to be treated as column 
data. If the message string is parsed as a delimited message, the table function preferably 
invokes a parsing UDF 70a, which takes the accessed message string and parses it according 
to a specified delimiter character, as is well known to those skilled in the art. 

The table function then converts the parsed data into relational table format, i.e., a 
row with columns of desired data types, in step 140. In step 150, the converted message data 
is returned to the client. 

According to a preferred embodiment of the present invention, the table function is 
custom built pursuant to user specifications. Preferably, the user launches a table function 
building (TFB) application running on the client computer system. The TFB application 
provides a graphical user interface (GUI) that collects pertinent information from the user 
including the desired table formatting. The TFB application includes, but is not limited to, 
the following function customizations: 

• Table function type (e.g., a receive (destructively read) or a read function) 

• Table function name 

• Specification of the database where the table function will be stored 

• Location of the messaging system queue 

• Messaging data format 
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• Column name and data type for each sub-string within the message 

• Option of creating a table view 

• Option of saving specifications for future use 

Each of the above function customizations will be discussed below. 
Specifying Table Function Type 

In Figure 3, a window 200 in accordance with a preferred embodiment of the present 
invention, the user is allowed to select a type of table function which will be built by the 
TFB application. As is seen, the user can choose to build a table function that RECEIVES 
(i.e., destructively reads) messages 201, or READs (non-destructively) messages 202 from 
the designated message queue 30. Additionally, the user can choose to build both table 
functions, one that destructively reads and one that reads messages 203. After the client has 
chosen the type of table function he or she wishes to build, the user can press the Next 
button 204 to continue with the building process or to cancel 205 the process altogether. 

Specifying the Table Function Name 

In Figure 4, the user is prompted to provide a name for the table function. If the user 
has chosen to build RECEIVE and READ table functions, the user is prompted to provide 
names for both UDFs. 

Designating the Database for Storage 

Typically, UDFs are stored in a database system. Thus, in Figure 5, the user is asked 
to provide information as to where the table function will be stored by providing a database 
name 220, User ID 221 and password 222 to access that database. For convenience, the user 
can designate his or her current User ID and password, if appropriate, by checking a box 
224. In a preferred embodiment, a Test Connection button 223 is provided to enable the user 
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to validate the database connection, User ID 221 and password 222. 
Designating the Location of the Desired Message Queue 

As indicated above, each computer system 10a, 10b, 10c in a network can maintain 
its. own message queue 30. In fact, a given computer system may be configured to run one 
or more queue managers each of which may control one or more message queues. 
Accordingly, the user must provide information regarding the location of the queue on which 
the message data of interest resides. In Figure 6, the user is prompted either to specify a 
specific location, e.g., service point and policy 231 in MQ Series Integrator®, or to select the 
system default 230. 

Specifying the Format of the Message Data 

Once the location of the message queue has been specified, the TFB application 
prompts the user to provide information as to how the message data is formatted. In a 
preferred embodiment, as is shown in Figure 7, the user may either specify the format 240 or 
specify the filename of a file from which formatting specifications can be read 241 . If the 
user chooses the former, the user can choose from two types of formats: (1) delimited 242 
and (2) fixed length 243. For delimited formatting 242, the user must specify the character 
that separates the message data into sub-strings which will be treated as column data. In 
Figure 7, therefore, a "%" symbol indicates a beginning and/or end of a sub-string in the 
message string. For fixed length formatting 243, the user specifies the position and length of 
each sub-string. 

In a preferred embodiment, if the user is not certain of how the message data is 
formatted, e.g., the user does not know what character delimits the message string, the user 
can press a Show Sample Content button 244 and a message string from the designated 
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message queue will be displayed to the user. By examining the message string, the user can 
easily determine the type of formatting for the message data, and can then provide the 
appropriate formatting information. 

Defining Column Name and Data Type 

In Figure 8, the user is prompted to specify a desired column name 250 and data type 
251 for each sub-string within the message string that is to be returned as a column. The 
data type is that into which the user would like to have the corresponding message sub-string 
returned. Thus, the user must designate a data type that is compatible with the 
corresponding message sub-string. For instance, the user cannot designate an integer data 
type for an alpha character sub-string. 

In a preferred embodiment, the user defines a new column by pressing an ADD 
button 252, which launches an Add Column Data dialog window, shown in Figure 8A. 
Additional buttons, e.g., CHANGE 253 and REMOVE 254, are provided to edit and delete 
column definitions, respectively. 

In another preferred embodiment, a SAMPLE RESULT button 255 is provided, 
which when activated, displays to the user the message data converted in accordance with 
the user's formatting specifications and column definitions. Figure 8B is an example of 
what might be displayed to the user after he or she has activated the SAMPLE RESULT 
button 255. This button allows the user to preview the converted data and to make any 
corrections in formatting, e.g. correcting data type specifications, before the table function is 
actually built. 

Option to Create a Table View and to Save the Formatting Specifications 

In a preferred embodiment, illustrated in Figure 9, the user is given the option of 
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creating a view of the table function 260 and/or saving the message data formatting and 
column definitions to a file 262. If the user chooses to create a table view 260, the user must 
specify a view name 261 and, optionally, a view comment 264. If the user also chooses to 
save the column specifications to a file 262, the user specifies a file name 263 to which the 
specifications will be saved. In this manner, the user can import the same specifications, if 
appropriate, into a new table function by specifying the filename at the message formatting 
stage (Figure 7, item 241), thereby saving time and effort. 

The list of customization specifications above is an exemplary list and is not meant 
to be exhaustive of all such specifications. Other specifications known to those skilled in the 
art may be appropriate, and those specifications would fall within the scope of the present 
invention. 

After the user has provided the pertinent information discussed above, the TFB 
application builds the table function according to the user's specifications. In a preferred 
embodiment, if the message data format is delimited, the TFB will check to see if a parsing 
UDF 70a exists in the DBMS 80. If it does not, the TFB will build the parsing UDF 70a that 
will parse the message string after it is retrieved or read by the messaging function. The 
TFB will then register the newly built parsing UDF 70a to the DBMS 80, where it can be 
invoked by other table functions created thereafter. 

In a preferred embodiment, the TFB application can display a summary window 270 
(Figure 10) to allow the user to review his or her customizations before the table function is 
built. The summary window 270 includes a SHOW SQL button 271, which when activated, 
displays the SQL statements making up the table function (see Figure 10A). 

The following example illustrates the operation of a table function built according to 
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the following user specifications. 

Message String: "John Jones%San Jose%39%M%36000" 



User Specifications: 



Table function name 


GetCustomerData 


Location of Message Queue 


System Default 


Message Formatting 


Delimited by "%" 


Column Definition (Data Type) 


Name (varchar(16)) 
City (varchar(20)) 
Age (integer) 
Sex (char(l)) 
Salary (decimal (10,2)) 


View Creation (Name) 


Yes (CustomerDataView) 



Given the specifications above, a table function named GetCustomerData is built. 
When invoked within an SQL statement, the table function invokes a messaging UDF to 
retrieve a message from the message queue at a location defined by the default service 
endpoint The table function then invokes a parsing UDF 70a to parse the message string as 
a delimited string, and then the table function converts each substring extracted by the 
parsing UDF into the specified data types. The table function returns each message on the 
queue as a five-column row. A table view named CustomerDataView is also built, which 
through a simple SQL statement, such as "SELECT * FROM CUSTOMERVIEW DATA," 
returns the message data as the following row: 



Name 


City 


Age 


Sex 


Salary 


John Doe 


San Jose 


39 


M 


36000.00 
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Thus, by utilizing the table view, an end user can select data directly from the table view, 
without having to invoke the table function directly. In fact, the end user could be 
completely isolated from the existence of the table function, how it operates, and how it is 
used. The only information the end user would need is the name of the table view, which the 
database administrator would typically provide. 

Because the table function retrieves and converts the message data into relational 
table format, the table function can be used within a single SQL statement to access the 
message data and to populate directly a relational table. The user is no longer required to 
perform conversion steps, e.g., parsing the message string, because the conversion is 
automatically performed by the table function. Moreover, the user can utilize the table view 
to select a message from the table view and then have the selected message string returned in 
relational table format. 

Although the present invention has been described in accordance with the 
embodiments shown, one of ordinary skill in the art will readily recognize that there could 
be variations to the embodiments and those variations would be within the spirit and scope 
of the present invention. For example, although the present invention has been described 
with reference to a queue-based messaging system, the principles can also be applied with a 
publish/subscribe-based system, as is well appreciated by those skilled in the art. 
Accordingly, many modifications may be made by one of ordinary skill in the art without 
departing from the spirit and scope of the appended claims. 
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